Welcome to ProtoView's ProtoGen Application Code Generator ---------------------------------------------------------- Read this README file for the latest, important information about the ProtoGen software and manual. TABLE OF CONTENTS ----------------- 1. How to Get Help 2. Installation 3. Features 4. Other Information 5. Defining your own editor 6. Windows 3.1 and Strict compiling 7. Other Products Offered From ProtoView 1. HOW TO GET HELP --------------- If you have any problems, read this file in its entirety. If you still have a question and need assistance, help is available from the following sources: a. Type GO BPROGB on the CompuServe for access to the Borland forums, which consist of libraries of technical information and answers to common questions. b. Check with your local software dealer or users' group. c. Call the Borland Technical Support Department at (408) 461-9133 for help with an urgent problem that cannot be solved by one of the previously mentioned sources. Please sign and return the license agreement that came with ProtoGen, and have the following information ready before calling: 1. The product name and serial number on your original distribution disk. Please have your serial number ready or we can't process your call. 2. The product version number. To find the version number, invoke ProtoGen and select Help|About ProtoGen. 3. The brands and model numbers of your computer and additional hardware. 4. The operating system and version number installed on your computer. Find the version number by typing VER at the DOS prompt. 2. INSTALLATION ------------ To start the installation, execute the "Setup" program on the ProtoGen installation disk. For example, if you're installing from drive A, perform the following steps: 1. At the A:\> prompt, type "WIN SETUP" . 2. Enter the destination directory for ProtoGen and press . 3. After Setup transfers files to the hard disk, Setup asks if it should add the PV directory to your path statement in the AUTOEXEC.BAT file. If you've already added the PROTOGEN directory to your path, select ; otherwise, select . 4. After installation, make sure your DOS path statement includes the PV directory, so the DLL and executable files can be found. If you allowed the Install program to modify the AUTOEXEC.BAT, rebooting sets the path properly. Read the rest of this README file to get further information about this release before installing ProtoGen. 3. FEATURES -------- ProtoGen offers the following features and benefits: o Allows various Windows resources to be laid out and connected into a prototype user interface. o Allows easy creation of menu items, separators, menu popups, and accelerators, which are implicitly tied to a menu item. o Demonstrates in test mode how the completed application will look. o Generates Borland C++ OWL code or ANSI C code for Windows, and creates associated files needed to compile the generated application, including make files and header files. o Creates project files that can be used to build C and C++ programs in Borland C++ for Windows. o Gives you the option of creating a customized main window or a a standard main window, which includes a system icon and minimize and maximize buttons. o Displays a user-defined menu of frequently used tools for easy access. o Provides "regeneration brackets" to prevent ProtoGen from overwriting user-modified codes. 4. OTHER INFORMATION ----------------- o System Error Message When loading ProtoGen, a "System Error" message might appear for one of the following reasons: - The DOS path has not been set correctly. Remedy: Exit Windows and add the ProtoGen directory to the DOS path. - The working directory is no longer valid. Remedy: Delete the PV.INI file in the WINDOWS directory. o Source Code Comments ProtoGen uses comments to delineate regeneration brackets. For example, suppose a user added the following global variable Foo between brackets: //REGEN_VARIABLES int Foo=1; //REGEN_VARIABLES The brackets protect Foo from destruction if the user interface prototype is regenerated to add or change menu features. If one of the brackets is deleted, Foo is lost when the prototype is regenerated. All regeneration brackets start with the prefix REGEN_. Delete brackets only after the code is frozen. o .PVA File Modification Don't modify .PVA files directly. Incorrect data can lead to an "Unrecoverable Application Error". Let ProtoGen modify these files. o Project Files for C++ and ANSI C When compiling projects under Borland C++ for Windows you should turn on the Generate COMDEFS switch under Compiler | Advanced Code Generation. This option can be found on TCW's main menu. o Working Directory The "working directory" is the directory where ProtoGen's Windows resources are kept. These include dialog resources, menu resources, bitmaps, and icon files. ProtoGen needs to draw upon the resources within this directory to build an application. To use resources in other directories, the ICON and BITMAP files have to be copied by the user if the Dialog Resource is using an icon control or Borland Custom control that uses a bitmap. ProtoGen attempts to copy all resource files to the current working directory. ProtoGen won't copy the associated files that might be used within a .DLG or .RC file. o Test Mode Test mode shows the general flow of the user-designed screen, demonstrating how data objects might interact. In test mode, there's no minimize button, but the minimize button will be present in the generated application along with other standard features. When the application is in test mode, the main ProtoGen window is hidden, and you can't see it in the task list for the program manager. When the main window is a dialog box, the created application behaves differently than it did in the test mode. o Tools Tools launched within ProtoGen don't close upon exiting ProtoGen. o Insufficient Memory or Disk Space When memory or disk space is low, you might not be able to compile a program. When you shell to DOS from Windows to compile the program, a large swap file is needed, which reduces available memory. Unload drivers, TSRs, and other memory-intensive programs, and try to recompile. o Setting Up ProtoGen Perform the following steps to prepare for generating ProtoGen code: 1. Set up the tools you need by selecting Tools|Define Tool from the ProtoGen main menu and defining the following tools, which reside in the bin directory of either Borland C++ or Turbo C++ for Windows unless you specified otherwise: - Resource Editor. To create Bitmaps, Fonts, and Dialogs, select WORKSHOP.EXE. 2. Set up appropriate paths for includes and libs. Select Application|Generate from the ProtoGen main menu. The INCLUDE and LIB directories should be searched in order of derived class first; consequently, if your Borland C++ directory is "C:\BC" then you should enter the following path in the Include Directory Edit box: C:\BC\OWL\INCLUDE;C:\BC\CLASSLIB\INCLUDE;C:\BC\INCLUDE Enter the following in the Library Directory Edit box: C:\BC\OWL\LIB;C:\BC\CLASSLIB\LIB;C:\BC\LIB Press as if you were generating code. When the Enter Application Title dialog is displayed, just press to cancel generating an application. Now, you're ready to use ProtoGen. 3. With the make file supplied by Borland, build the appropriate versions of .LIB files for Borland classlibs. Because Borland C++ and Turbo C++ for Windows are shipped with only the small code model versions of the classlibs, you'll need to build any other versions you might need. See the Borland C++ documentation for more information. o Inaccuracies in Screens Because ProtoGen is concerned primarily with the overall screen flow and interaction with other Window resources, some screens might not be accurately portrayed. For example, a button may appear slightly larger than its actual size. o Custom Colors To define a custom color for the client area of the main window from the Edit|Window Colors menu, select a "Basic Color" first, modify the color, and press the button. The custom color is displayed in the first available blank square. o Linking Dialog Resources You can't link a dialog resource to more than one menu item. If you need to use the same dialog, copy the dialog resource and rename it. Don't change the name of a dialog that's linked to a menu item. o Putting Away a User-defined Dialog When you click on a menu item in the prototype menu, ProtoGen asks you what DLG file you want to attach to it. (A DLG file is equivalent to an RC file). When you click a dialog control like the button, ProtoGen thinks you want to attach a dialog to that control. To put away the dialog, either double click the client area of the dialog or press . o Using an RC File as a Menu Resource File. When naming an RC file to be used as the menu resource file (MNU), don't use the application file name. If the menu resource file is HELLO.RC, and the name of the application is HELLO, ProtoGen overwrites HELLO.RC with its own RC file when it generates code. To help you avoid overwriting files, by default ProtoGen gives files an MNU file name extension if you don't enter an extension when you save the file from the Menu Designer. o Nested Dialog Boxes Don't nest dialog boxes more than nine levels. More levels might cause an Unrecoverable Application Error, because stack space is limited. o Debug Warning Messages Don't panic if dbWin displays the following error message when you're running the Debug Windows Kernel: "PROTOGEN -> USER PV_WM_KILLFOCUS + 1E: Invalid value 256" This message is displayed during normal operation with the Debug Windows Kernel. o Compatibility Issues Many of the message dialog boxes are system modal, which means the user can't access other parts of the application until the dialog is finished; consequently, ProtoGen might not be compatible with programs like Recorder in your Windows Accessories Group. When using a high resolution driver, such as the 1024x768 with small fonts, the text in several dialog boxes is truncated. To correct the problem, select a larger font, such as the one available with the 1024x768 driver with large fonts. o Built-in Text Editor While working in the built-in text editor (which is brought up by selecting a menu item from Edit|Edit Resources), if the Save As or Open dialog box is displayed, you must first close this dialog before selecting File|Close from the ProtoGen system menu. 5. DEFINING YOUR OWN EDITOR. ------------------------ Edit or create a PV.INI file in your WINDOWS directory, and define the TextEditor variable as the executable file name of your editor as shown here: [ViewPaint] TextEditor=myeditor.exe For example, if your editor is Brief, TextEditor=b.exe. 6. WINDOWS 3.1 AND STRICT COMPILING -------------------------------- If you're using Borland C++ and OWL version 3.1 and want to generate C or C++ code that conforms to Microsoft's STRICT definition, select Application| Generate. In the Options area of the Generate dialog box, select the STRICT checkbox to define -DSTRICT and -DWIN31. To generate STRICT-compliant code that runs under Windows 3.0 or 3.1, replace the -31 command line switch passed to the rc compiler with a -30 switch. 7. OTHER PRODUCTS OFFERED FROM PROTOVIEW ------------------------------------- DataTable - Spreadsheet control for Microsoft Windows for the C/C++ and Pascal windows programmer. ProtoView - A screen management facility for Microsoft Windows for the C/C++ Windows programmer. Includes 12 new Windows controls with built in data validation, DDE links, and message handling; a screen painter to interactivly design screens and forms with data validation, actions, DDE links, custom colors and fonts and much more; a dialog class for Object Windows Library, and a high-level dynamic link library with functions for printing files and buffers under Windows; an editor function, animation functions and more. ProtoView works with ProtoGen to enhance test mode and ProtoGen's code generation capabilities.